3. 功能模块详细设计

3.1 资产管理

CRUD操作细节：

操作	接口	请求体	响应	特殊逻辑
创建	POST /api/v1/assets	完整资产字段JSON	201+资产详情	自动生成asset_code、qr_code_url、触发审批流程
查询	GET /api/v1/assets?filters	query参数: type/status/floor/keyword	200+分页列表	支持全文检索(ES)、空间筛选(地图框选)
详情	GET /api/v1/assets/{id}	—	200+资产详情(含关联数据)	关联显示: 空间路径、科室信息、工单历史、传感器数据
更新	PUT /api/v1/assets/{id}	部分字段JSON	200+更新后详情	状态变更需校验状态机流转合法性
删除	DELETE /api/v1/assets/{id}	—	204	仅draft状态可删除，active需先转inactive

批量导入导出：

操作	格式	模板字段	校验规则	性能要求
导入	Excel(.xlsx)	asset_code, asset_name, asset_type, location_path, specification…	必填校验+编码唯一性+类型枚举校验+位置路径解析	5000行≤60s
导出	Excel/PDF	同上+关联字段(科室名/供应商名/状态历史)	支持筛选后导出	10000行≤30s

二维码生成规则： - 编码内容：https://sign.hospital.com/q/{asset_code} - 纠错等级：M（15%纠错，医疗环境标识可能有磨损） - 尺寸：标识牌二维码≥30×30mm（手机可扫），小标签≥15×15mm - 扫码页面：标识详情+报修按钮+位置地图

状态机实现：

当前状态	可流转状态	触发条件	需审批
draft	active	安装验收通过	是(标识管理员)
active	repairing	故障工单创建	否(自动)
active	inactive	科室撤销/标识过时	是(标识管理员)
repairing	active	维修完成验收通过	是(维修人员+科室确认)
repairing	inactive	维修不可行/成本过高	是(标识管理员)
inactive	scrapped	报废审批通过	是(标识管理员+院领导)
inactive	active	恢复使用	是(标识管理员)
scrapped	—	终态，不可流转	—

3.2 规划设计

VI规范在线查阅： - 按分类索引：基础系统(标志/标准字/标准色/辅助图形)→应用系统(标识牌/门牌/指引牌/户外标识)→制作规范(材料/工艺/安装) - 每条规范包含：规范描述+设计图稿(矢量SVG)+制作参数(尺寸/色值/材质/工艺) - 版本管理：规范变更需审批，历史版本可回溯，支持差异对比

图标符号库：

分类	图标数量	格式	规范
方向指示	24	SVG+PNG(3倍)	GB/T 10001.1-2012 公共信息图形符号
科室标识	60+	SVG+PNG	医疗行业专用图标集
安全警示	40+	SVG+PNG	GB 2894-2008 安全标志
消防标识	20+	SVG+PNG	GB 13495.1-2015 消防安全标志
无障碍标识	10+	SVG+PNG	GB/T 31521-2015 无障碍标识
设施标识	30+	SVG+PNG	卫生间/电梯/楼梯/餐厅/停车场等

方案管理： - 方案实体：方案名称/区域/设计文件(多版)/状态(草稿/审核中/已批准/已实施) - 版本控制：每次编辑自动生成新版本(v1.0→v1.1→v2.0)，可对比任意两版差异 - 方案到实施的映射：方案中的每个标识项→关联sign_asset记录，实现从设计到资产的追溯

3.3 制作安装

在线申请流程：

科室用户填写申请单
  ├─ 申请类型: 新增/更换/拆除/搬迁
  ├─ 标识类型/内容/位置/紧急程度
  ├─ 上传参考图(可选)
  └─ 提交
       │
       ▼
标识管理员审核
  ├─ 驳回(退回修改)
  └─ 通过
       │
       ▼
制作派单
  ├─ 自制(院内制作)
  └─ 外协(供应商制作)
       │
       ▼
供应商确认接单+进度上报
  ├─ 已接单→制作中→已完工→已发货
  └─ 每个节点自动更新系统状态
       │
       ▼
安装派单
  ├─ 指派安装人员
  └─ 安装人员确认+现场安装
       │
       ▼
验收确认
  ├─ 科室用户确认(拍照上传)
  └─ 标识管理员终验
       │
       ▼
流程闭环→资产状态→active

多级审批流程配置：

配置项	说明	示例
审批层级	1-3级可配置	一般申请1级(标识管理员)，≥5000元2级(+后勤处长)，≥20000元3级(+分管院长)
审批条件	基于金额/类型/区域的规则	户外标识自动加审(后勤处长+保卫处)
加急通道	P0级申请跳过部分审批	紧急安全标识→标识管理员直接批准
超时自动	审批超时自动流转	24h未审批→自动通过(可配置)

供应商管理：

管理项	字段/指标	评分权重
基本信息	公司名/资质/联系方式/合作起始日	—
资质管理	营业执照/生产许可证/ISO9001/环保认证	准入门槛
绩效评分	交期准时率(30%)/质量合格率(30%)/响应速度(20%)/价格竞争力(20%)	月度自动计算
黑名单	连续2月绩效<60分→暂停合作3月，<40分→列入黑名单	自动触发

3.4 运维管理

巡检计划配置：

参数	说明	示例
巡检周期	按标识类型/位置配置	户外标识月检，室内标识季检，数字标识周检
巡检路线	按区域规划最优路线	A栋1F→2F→3F→B栋1F…
巡检项	检查内容清单	外观(清洁/损坏)/固定(松动/脱落)/内容(清晰/准确)/照明(亮度/均匀)/电子屏(显示/触控)
巡检人员	按区域分配	A栋→张三，B栋→李四

移动端巡检流程：

登录APP→接收今日巡检任务
  →到达标识位置(扫码确认/NFC触碰)
  →逐项检查(拍照+评分:正常/轻微/严重)
  →发现异常→一键上报→自动生成工单
  →巡检完成→提交巡检报告

工单管理生命周期：

状态	触发	SLA	超时处理
待派发	问题上报/巡检发现/传感器告警	≤30min派发	超时自动派发(轮询策略)
已派发	维修人员接收	≤4h响应(普通)/≤1h(紧急)	超时升级通知标识管理员
处理中	维修人员到场处理	≤48h(普通)/≤8h(紧急)	超时升级通知后勤处长
待验收	维修完成提交	≤24h验收	超时自动通过(可配置)
已关闭	验收通过	—	—
已退回	验收不通过	退回处理中	重新计时

3.5 内容管理

科室信息维护： - 与HIS系统双向同步：HIS为主数据源，标识系统可补充扩展字段（如科室英文翻译、科室简介） - 变更检测：HIS推送科室变更事件(新增/更名/搬迁/撤销)→标识系统自动生成内容变更工单 - 审核机制：HIS同步的科室名直接生效，英文翻译/科室简介需标识管理员审核

双语词库管理：

词库类型	条目数(典型三甲)	维护规则
科室名中英文	80-150	HIS同步中文+人工翻译英文
医生职称中英文	20	标准翻译(主任医师→Chief Physician)
方向/楼层词	30	标准翻译(左→Left，3楼→3F)
警示语中英文	40	标准翻译(禁止吸烟→No Smoking)
检查/治疗项目中英文	100+	医学标准翻译
设施词中英文	50	标准翻译(电梯→Elevator)

内容变更自动触发机制：

触发事件	监听源	联动动作
科室更名	HIS科室信息变更事件	查询关联标识→生成内容更新通知→数字标识自动更新→物理标识生成更换工单
科室搬迁	HIS科室位置变更事件	更新空间关联→生成标识迁移工单→导航地图更新
医生排班变更	HIS排班系统	联动诊室门牌屏内容更新
双语词库更新	词库审核通过事件	查询引用该词的标识→生成更新通知

3.6 电子标识

内容发布流程：

内容编辑(模板+数据源绑定)
  →预览(所见即所得)
  →提交审核(内容审核+VI合规审核)
  →审核通过→排期(即时/定时)
  →排期引擎→按设备组下发内容
  →MQTT推送到设备→设备下载→校验(MD5)→按排期播放
  →播放日志回传→审计

设备监控指标：

监控项	采集频率	告警阈值	告警级别
设备在线状态	30s心跳	连续3次心跳丢失	P1
CPU使用率	1/min	>85%持续5min	P2
内存使用率	1/min	>90%	P2
存储使用率	1/h	>85%	P2
屏幕亮度	1/min	偏差>30%设定值	P2
播放状态	1/min	黑屏/静止画面>2min	P0(急诊)/P1(其他)
网络延迟	1/min	>500ms	P2
传感器数据异常	事件触发	超阈值	P1-P2

3.7 数据分析

仪表盘设计（4象限布局）：

象限	核心指标	图表类型	数据刷新
左上-资产总览	总数/在线率/故障率/分布热力图	数字卡片+热力图	5min
右上-运维效率	工单处理时长/巡检完成率/SLA达标率	折线图+仪表盘	5min
左下-成本分析	月度维修费用/更换费用/新增费用	堆叠柱状图	日
右下-预警提醒	质保到期/巡检到期/设备异常	列表+倒计时	实时

报表类型清单：

报表	维度	度量	频率	导出格式
资产台账	院区/楼栋/楼层/类型	数量/面积/金额	月	Excel/PDF
维修统计	月份/区域/类型/供应商	工单数/平均处理时长/费用	月	Excel/PDF
巡检报告	月份/区域/巡检员	巡检数/异常率/闭环率	月	PDF
设备运行报告	月份/设备类型	在线率/故障率/播放覆盖率	月	PDF
年度总表	年度汇总	全部指标年度汇总	年	PDF
质保到期预警	30天/60天/90天内到期	资产清单+费用预估	周	Excel
碳足迹报告	季度	运行碳排放/制造碳排放/减排效果	季	PDF

---